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HandyAsm is a 65c02 cross assembler, designed to run on an Amiga 
computer, and used primarily for the development of software for the Lynx 
hand-held game system. It is assumed that the reader of this document is 
familiar with the 65c02 instruction set, addressing modes and mnemonics. 
HandyAsm is a one-pass assembler (for speed) with expression resolution at 
the end. 


Running the assembler & command line options 


From the CLI prompt, type: 

asm <filel> [<file2> ... [<filen>]] [<optl> [<opt2> ... 3 ] 

here filel, file2, etc. specify source files to assemble. If no extension 
is provided in a file name, an extension of .src is assumed. If more than 
one file name is specified, the files are treated as one continuous source. 
The assembled output is written to a file in Epyx's BIN format. The default 
name for the assembler output is taken from the root of the first source 
file name with .bin appended. 

Command line options are specified with either + or - as the first 
character, followed by the option letter, optionally followed by an argument 
string. A summary of the command line options follows: 

+B<size> - Output buffer size (default 73728) 

The output buffer must be large enough to hold the 
BIN output file and all unresolved target files. If 
assembly fails due to output buffer overflow, use 
this option to increase it. 

+C - Generate a complete listing (used with +L or +X option) 
This option requires that a BIN file exist from a 
previous successful assembly. The BIN file is used 
to resolve forward address references. 

+D<symbol>[=^<value>] - Define symbol 

Define the specified symbol and set it equal to 
value or to -1 if value not specified. 

^ +E.- Save equated symbols (used with +S option) 

Save all symbols to the symbol file. Normally 



